{ToolManager

{En ut�kning av Amigans Workbench

{

{Version 3.0

{23 Feb 1997

Tillst�nd har utf�rdats f�r att g�ra och distribuera exakta kopior av den h�r manualen, under f�ruts�ttning att upphovsr�ttsinformationen och denna tillst�ndsinformation bibeh�lls p� alla kopior.

UPPHOVSR�TT

Upphovsr�tt © 1990–1997 Stefan Becker

Inget program, dokument, datafil eller k�llkod fr�n detta mjukvarupaket f�r, antingen i sin helhet eller delvis, inkluderas eller anv�nds i andra mjukvarupaket, s�vida inte detta har auktoriserats med ett skriftligt tillst�nd av f�rfattaren.

INGEN GARANTI

Det finns inte n�gon garanti f�r detta mjukvarupaket. �ven om f�rfattaren har f�rs�kt undvika fel kan han inte garantera att mjukvarupaketet beskrivet i detta dokument �r 100% p�litligt. Du anv�nder d�rf�r detta material p� din egen risk. F�rfattaren kan inte h�llas ansvarig f�r skador som orsakas av anv�ndandet av detta mjukvarupaket.

DISTRIBUTION

Detta mjukvarupaketet �r fritt distribuerbart. Det kan �verf�ras till godtyckligt media som anv�nds f�r distribution av fri programvara, s�som diskettsamlingar f�r fri programvara, cd-rom, FTP-servrar och BBS:er.

F�r att f�rs�kra sig om fullst�ndigheten av detta mjukvarupaket b�r distribut�rerna anv�nda sig av de ursprungliga arkivfilerna:

F�rfattaren kan inte h�llas ansvarig om detta mjukvarupaket har blivit oanv�ndbart p� grund av �ndringar i arkivinneh�llet eller arkivfilerna i sig.

Det finns inte n�gon gr�ns p� den avgift som tas ut av distribut�rerna, f�r t.ex. mediakostnader - s�som disketter, band eller cd-skivor - eller f�r dupliceringsprocessen. S�dana gr�nser har visat sig vara skadliga f�r fritt distribuerbar mjukvara. T.ex. s� har mjukvarupaket tagits bort ist�llet f�r att priset p� en diskett har minskats till under en viss gr�ns.

�ven om f�rfattaren inte s�tter n�gra gr�nser p� dessa avgifter, vill han uttrycka sina personliga �sikter i �mnet:

• Det h�r mjukvarupaketet b�r g�ras tillg�ngligt f�r alla utan kostnad, n�r detta �r m�jligt.
• Om du har k�pt detta mjukvarupaket p� en diskett, under normala omst�ndigheter, fr�n en f�rs�ljare av fria program och har betalat mer �n 5 DM, 5 US$ eller motsvarande, har du definitivt betalat f�r mycket. Sn�lla, st�dj inte denna orimligt h�ga vinstmarginal l�ngre, utan byt till en billigare k�lla s� snart som m�ligt.

ANV�NDNINGSBEGR�NSNINGAR

Inget program, dokument, datafil eller k�llkod fr�n detta mjukvarupaket, f�r, antingen i sin helhet eller delvis, anv�ndas p� en dator som anv�nds:

• f�r forskning, utveckling, konstrution, testning eller produktion av vapen, eller n�gra andra milit�ra anv�ndningar. Detta inkluderar datorer som anv�nds f�r utbildning f�r n�got av ovanst�ende syften.
• av m�nniskor som accepterar, st�djer, eller anv�nder v�ld mot andra m�nniskor, t.ex. medborgare fr�n andra l�nder.

(Denna sida �r medveted l�mnad tom)

1 Om du tycker om ToolManager…

ToolManager �r giftware, inte shareware!

Om du tycker om programmet och anv�nder det ofta, b�r du �verv�ga att skicka en liten donation eller g�va, f�r att tacka f�r det arbete jag har lagt ner p� programmet. Jag f�resl�r en donation p� 10–20 US$ eller 10–20 DM. Sn�lla, skicka inte checker eller postanvisningar fr�n l�nder utanf�r Europa, eftersom det ofta kostar mer att l�sa in dem �n vad beloppet �r p�.

Om du inte har r�d att skicka en donation m�ste du inte f� d�ligt samvete f�r det. Men du m�ste i alla fall skicka mej ett vykort eller brev, d�r du s�ger att du anv�nder ToolManager (jag gillar att f� beundrarbrev :-). See section f�rfattare.

2 Om framtiden f�r ToolManager

Sedan den senaste stora versionen av ToolManager (version 2.1) i maj 1993 har det varit en besv�rlig tid f�r Amigan och dess anv�ndare. N�r detta skrivs ser framtiden fortfarande inte v�rst ljus ut. Trots detta har jag beslutat mig f�r att utveckla den h�r versionen av ToolManager 3.0, p� grund av den enorma respons jag fick fr�n hundratals n�jda anv�ndare.

Min p�litliga A3000 b�rjar nu bli gammal, och med den nuvarande situationen �r det os�kert vilken riktning Amigan kommer att ta. Jag har inte r�d att k�pa varje uppdatering, eller n�gra av de (eventuellt) nya datorerna, eftersom detta projekt bara �r en hobby. Det �r allts� din respons och dina donationer som avg�r om jag kan arbeta p� framtida versioner av ToolManager.

Detta �r ocks� en uppmaning till de f�retag som arbetar p� framtida Amigor (Amiga Technologies, Phase5, ProDAD, Gateway2000, eller vilka som f�r tillf�llet �r inblandade). Jag �r bara en f�rfattare av fri programvara, och har inte r�d att k�pa alla m�jliga system, eller att betala f�r utvecklarmaterialet f�r varje system. Jag beh�ver allts� ert st�d om du vill se ToolManager till ert system. Kom ih�g att ToolManager �r ett av de (om inte det) mest anv�nda verktygen p� Amigan, och det vore med andra ord en f�rdel f�r ert system.

Framtiden f�r ToolManager beror p� ditt st�d!

3 Hur du kontaktar f�rfattaren

F�rfattaren kan n�s p� f�ljande adresser:

Vanlig post:

        Stefan Becker
        Bonner Ring 68
D-50374 Erfstadt
        GERMANY

Elektronisk post:

stefanb@yello.ping.de

Det finns ocks� en hemsida f�r ToolManager:

http://www.ping.de/sites/yello/toolmanager.html

4 Vad beh�vs f�r att k�ra ToolManager?

ToolManager beh�ver �tminstone:

AmigaOS 3.0 (V39)

F�r b�ttre minneshantering och picture.datatype.

WBStart 2.2

F�r att starta Workbench-program.

DOSPath 1.0

F�r att hantera programs�kv�gar.

Dessutom st�djer ToolManager:

ScreenNotify 1.0

Med detta kan ToolManager �ppna och st�nga sina dockf�nster n�r en allm�n sk�rm �ppnas eller st�ngs.

picture.datatype V43

Ut�kningarna i denna f�rb�ttrade picture.datatype st�djs automatiskt om det �r installerat i ditt system. See section tack till.

Inst�llningsredigeraren kr�ver:

AmigaOS 3.0 (V39)

F�r b�ttre minneshantering.

MUI 3.7

Det objektorienterade systemet f�r anv�ndargr�nssnitt. See section Information om MUI.

Pophotkey, Popport, Popposition

MUI-klasser f�r vissa dialogrutor. See section tack till.

5 Hur du installerar ToolManager

Var god anv�nd det medf�ljande installationsskriptet f�r att installera ToolManager. Det kr�ver AmigaOS Installer version 43.3 (eller h�gre). Denna version finns p� Aminet.

Se till att du har avslutat det gamla versionen av ToolManager innan du installerar den nya!

6 Koncept som anv�nds i ToolManager

ToolManager �r ett program som l�ter dig starta program p� ett mycket enkelt s�tt. Du kan starta program genom att anv�nda ett direktval (via tangentbordet, see section direktval), genom att v�lja ett alternativ i verktygsmenyn i Workbench, klicka p� en ikon i Workbench-f�nstret, eller klicka p� en knapp i ett speciellt dockf�nster. Du kan �ven sl�ppa ikoner fr�n Workbench-l�dor p� ovan n�mnda ikoner och knappar, f�r att skicka de sl�ppta filerna som argument till programmen. Du kan dessutom l�gga till ljud till var och en av dessa h�ndelser.

Alla de h�r sakerna kontrolleras av ToolManager-objekt. Varje objekt har en specifik uppgift, och inneh�ller information om hur denna uppgift skall utf�ras. T.ex. representeras program av programobjekt, och dessa objekt inneh�ller information om programmets namn och hur stor stack som ska anv�ndas.

Det finns tv� typer av objekt. Klasserna programobjekt, bildobjekt och ljudobjekt kallas f�r enkla objekt, eftersom de bara inneh�ller information om ett program, en bild eller ett ljud.

Klasserna menyobjekt, ikonobjekt och dockobjekt kallas sammansatta objekt, eftersom de kopplar samman flera enkla objekt f�r att utf�ra sin uppgift. T.ex., en ikon i Workbench-f�nstret representeras av ett ikonobjekt, som har en l�nk till ett bildobjekt f�r sj�lva ikonens utseende, samt en l�nk till ett programobjekt, som kommer att starta ett program n�r ikonen aktiveras.

6.1 Program

Ett programobjekt inneh�ller information om ett program som ska startas n�r objektet aktiveras. Objektet kan aktiveras direkt av anv�ndaren genom att anv�nda ett direktval, eller genom ett sammansatt objekt. N�r objektet aktiveras kan ett antal filer skickas med till programmet som argument. Programobjekt konfigureras med redigeringsf�nstret f�r programobjekt.

ToolManager kan starta flera olika sorters program:

Skal

Programmet k�rs som ett skalprogram, som om anv�ndaren hade matat in kommandoraden i ett skal. Kommandofiler m�ste startas p� detta s�tt. Du kan anv�nda den vanliga platsh�llaren ‘[]’ f�r att ange var fil argumenten ska placeras i kommandoraden.

Workbench

En start fr�n Workbench simuleras. Alla filer skickas med som Workbench-argument. Program som bara kan startas fr�n skal (inklusive kommandofiler) kommer inte att fungera om de startas som Workbench-program.

ARexx

Ett ARexx-program eller -kommando k�rs.

Docka

Kommandot specificerar en ToolManager-docka som ska aktiveras. Du kan anv�nda denna programtyp f�r att skapa dockor som ligger i andra dockor.

Direktval

Ett direktval genereras. Detta kan anv�ndas f�r att kontrollera ett annat program fr�n ToolManager.

6.2 Bilder

Ett bildobjet inneh�ller information om en bild som anv�nds av ett sammansatt objekt. ToolManager kan bara l�sa Workbench-ikoner f�r bildobjekt som anv�nds av ikonobjekt. N�r en docka anv�nder ett bildobjekt l�ses bilden som en datatyp. Tack vere detta kan ToolManager anv�nda varje bildformat som du har installerat en datatyp f�r. Bildobjekt konfigureras med redigeringsf�nstret f�r bildobjekt.

6.3 Ljud

Ett ljudobjekt inneh�ller information om ett ljudkommando. Detta kommando skickas som ett ARexx-kommando till en extern ljudspelare. Ljudobjekt konfigureras med redigeringsf�nstret f�r ljudobjekt.

6.4 Poster i Workbench verktygsmeny

Ett menyobjekt �r ett sammansatt objekt som binder ihop ett programobjekt och ett ljudobjekt f�r att skapa ett alternativ f�r verktygsmenyn i Workbench. N�r detta menylaternativ v�ljs aktiveras programobjektet och ljudobjektet. Varje vald Workbench-ikon skickas med som argument till programmet. Menyobjekt konfigureras med redigeringsf�nstret f�r menyobjekt.

6.5 Ikoner i Workbench-f�nstret

Ett ikonobjekt �r ett sammansatt objekt som binder ihop ett programobjekt, ett bildobjekt och ett ljudobjekt f�r att skapa en ikon i Workbench-f�nstret. Bildobjektet anv�nds f�r att skapa ikonbilden. Ikonobjekt konfigureras med redigeringsf�nstret f�r ikonobjekt.

Ikoner kan aktiveras p� tv� olika s�tt. Anv�ndaren kan dubbelklicka ikonen, eller s� kan hon v�lja andra Workbench-ikoner och sl�ppa dem p� ikonen. N�r ikonen aktiveras, aktiveras �ven programobjektet och ljudobjektet. De ikoner som har sl�ppts p� ikonen anv�nds som argument till programmet.

6.6 Knappf�nster

Ett dockobjekt �r ett sammansatt objekt som visar ett f�nster med knapprader f�r anv�ndaren. Varje knapp binder ihop ett programobjekt, ett bildobjekt och ett ljudobjekt. Varje knapp kan visa antingen en text, en bild, eller b�de och. Namnet p� programobjektet anv�nds som text. Bildobjektet anv�nds f�r bilden. Dockobjekt konfigureras med redigeringsf�nstret f�r dockobjekt.

Varje knapp kan aktiveras p� tv� s�tt. Anv�ndaren kan klicka p� knappen, eller s� kan han v�lja Workbench-ikoner och sl�ppa dem p� knappen. N�r knappen aktiveras, aktiveras �ven programobjektet och ljudobjektet. De ikoner som har sl�ppts p� knappen anv�nds som argument till programmet.

Ett dockobjekt kan "aktiveras" med ett direktval. N�r dockf�nstret �r st�ngt och anv�ndaren anv�nder direktvalet �ppnas f�nstret, och vice versa.

Om ‘screennotify.library’ �r installerat kan ToolManager �ppna och st�nga dockf�nster automatiskt. Varje g�ng en sk�rm ska st�ngas, st�ngs alla dockf�nster p� denna sk�rm f�rst. N�r den allm�na sk�rmen �ppnas, �ppnas alla dockf�nster f�r den aktuella sk�rmen igen.

7 Hur du konfigurerar ToolManager

ToolManagers inst�llningsredigerare anv�nds f�r att konfigurera ToolManager.

Objektredigeringsf�nster:

Diverse f�nster:

Inst�llningsredigeraren f�rst�r de normala verktygstyperna och kommandoradsargumenten:

FROM (Endast fr�n skal)

Anger filen som redigeraren ska l�sa inst�llningarna fr�n.

EDIT (F�rvalt)

Redigera inst�llningarna.

USE

Anv�nd de angivna inst�llningarna tempor�rt.

SAVE

Anv�nd de angivna inst�llningarna permanent.

CREATEICONS

Skapa ikoner f�r inst�llningsfiler som sparas. N�r inst�llningsredigeraren startas fr�n Workbench �r detta f�rvalt. N�r inst�llningsredigeraren startas fr�n ett skal �r detta inte f�rvalt.

7.1 Huvudf�nstret

Huvudf�nstret inneh�ller listor f�r de olika objekten. Genom att klicka p� objektklasserna kan du v�lja vilken lista som ska vara synlig. Varje lista kan inneh�lla flera grupper. Varje grupp kan inneh�lla flera objekt.

Genom att dubbelklicka p� ett gruppnamn �ppnar du gruppf�nstret. Genom att klicka p� symbolen till v�nster om gruppnamnet �ppnar och st�nger du gruppen i fr�ga. Om en grupp �r �ppen kan du se alla objekt som finns i den aktuella gruppen. Genom att dubbelklicka p� ett objekt �ppnar du ett f�nster f�r att redigera objektet i fr�ga.

F�r att flytta en grupp v�ljer du den f�rst, och drar den sedan till den nya positionen medans du h�ller den v�nstra musknappen nedtryckt. Sl�pp sedan sedan musknappen n�r gruppen �r vid �nskad position. Du kan �ven flytta objekt inom och mellan grupper p� detta s�tt.

Nedanf�r listan finns fyra knappar:

Ny grupp

Skapar en ny (tom) grupp. Gruppf�nstret �ppnas, och du kan ange namnet p� den nya gruppen.

Nytt objekt

Skapar ett nytt objekt i den valda gruppen. Ett f�nster kommer ett �ppnas d�r du kan ange attributen f�r det nya objektet.

Ta bort

Tar bort den valda gruppen eller det valda objektet. Om gruppen som �r vald ocks� inneh�ller objekt, kommer dessa objekt ocks� att tas bort.

Sortera

Om ett objekt eller en grupp �r vald, kommer inneh�llet i denna grupp att sorteras alfabetiskt. Om ingen post �r vald sorteras grupperna alfabetiskt.

Med knapparna l�ngst ned i huvudf�nstret kan du tala om f�r inst�llningsredigeraren var inst�llningarna skall sparas. Namnet p� inst�llningsfilen �r ‘ToolManager.prefs’.

Spara

Sparar inst�llningarna i l�dorna ‘EnvArc:’ och ‘Env:’. De nya inst�llningarna kommer automatiskt att �verleva en omstart. Efter det att inst�llningarna har sparats kommer inst�llningsredigeraren att avslutas.

Anv�nd

Sparar inst�llingarna i l�dan ‘Env:’. De nya inst�llningarna kommer automatiskt att anv�ndas, men de kommer inte att �verleva en omstart. Efter det att inst�llningarna har sparats kommer inst�llningsredigeraren att avslutas.

Prova

Sparar inst�llningarna i l�dan ‘Env:’. De nya inst�llningarna kommer automatiskt att anv�ndas, men de kommer inte att �verleva en omstart. Inst�llningsredigeraren avslutas inte.

Avbryt

Inst�llningsredigeraren avslutas. Alla �ndringar som inte har sparats kommer att kastas bort.

7.2 Hur programobjekt konfigureras

Programobjekt inneh�ller information om program. Redigeringsf�nstret inneh�ller f�ljande knappar:

Namn

Objektets namn.

Programtyp

Typ av program. Du kan v�lja mellan skal, Workbench, ARexx, docka, direktval och n�tverk. Typen n�tverk st�djs f�r tillf�llet inte.

Kommando

Namn p� kommandot. Detta �r antingen ett filnamn, namnet p� ett dockobjekt, eller en beskrivning av ett direktval, beroende p� programtypen.

Direktval

Det direktval som aktiverar detta programobjekt.

Stack

Storleken p� stacken f�r kommandot. ToolManager ser till att denna stack alltid �r minst 4096 bytes.

Prioritet

Prioriteten f�r kommandot. Normalt sett b�r du anv�nda det f�rvalda v�rdet 0.

Argument

Om denna knapp �r kryssad skickas filer (valda eller sl�ppta ikoner) med till kommandot som argument. Annars ignoreras filerna.

Flytta fram

Om denna knapp �r kryssad kommer den angivna allm�na sk�rmen att flyttas fram innan kommandot startas.

Aktuell l�da

Kommandot startas fr�n denna l�da.

S�kv�g

H�r kan du ange ett antal l�dor (separerade med semikolon) som program ska anv�nda sig av n�r de s�ker efter andra program.

Utmatning

Utmatningen fr�n skalprogram hamnar i denna fil. Om du anger ett konsollf�nster kommer b�de utmatningen fr�n och inmatningen till skalprogrammet att anv�nda detta f�nster.

Allm�n sk�rm

Anger den allm�na sk�rm som ska flyttas fram innan kommandot startas.

7.3 Hur bildobjekt konfigureras

Bildobjekt inneh�ller information om bilder. Redigeringsf�nstret inneh�ller f�ljande knappar:

Namn

Objektets namn.

Fil

Namnet p� den fil som bilddatan ska h�mtas fr�n. Normalt sett beh�ver du ta bort det avslutande ‘.info’ om du vill h�mta en ikon.

7.4 Hur ljudobjekt konfigureras

Ljudobjekt inneh�ller information om ljud. Redigeringsf�nstret inneh�ller f�ljande knappar:

Namn

Objektets namn.

Kommando

Det ARexx-kommando som ska skickas till den externa ljudspelaren.

ARexx-port

Namnet p� den ARexx-port den external ljudspelaren har �ppnat. F�rvalt namn �r PLAY, som anv�nds av programmet ‘UPD’.

7.5 Hur menyobjekt konfigureras

Menyobjekt inneh�ller information om alternativ i verktygsmenyn i Workbench. Redigeringsf�nstret inneh�ller f�ljande knappar:

Namn

Objektets namn. Detta namn anv�nds �ven som texten f�r menyalternativet.

Programobjekt

L�nk till det kopplade programobjektet. Anv�nd drag och sl�pp fr�n huvudf�nstret eller urklippsf�nstret f�r att koppla ett objekt. Du kan redigera det kopplade objektet genom att klicka p� det.

Ljudobjekt

L�nk till det kopplade ljudobjektet. Anv�nd drag och sl�pp fr�n huvudf�nstret eller urklippsf�nstret f�r att koppla ett objekt. Du kan redigera det kopplade objektet genom att klicka p� det.

7.6 Hur ikonobjekt konfigureras

Ikonobjekt inneh�ller information om ikoner i Workbench-f�nstret. Redigeringsf�nstret inneh�ller f�ljande knappar:

Namn

Objektets namn.

Programobjekt

L�nk till det kopplade programobjektet. Anv�nd drag och sl�pp fr�n huvudf�nstret eller urklippsf�nstret f�r att koppla ett objekt. Du kan redigera det kopplade objektet genom att klicka p� det.

Bildobjekt

L�nk till det kopplade bildobjektet. Anv�nd drag och sl�pp fr�n huvudf�nstret eller urklippsf�nstret f�r att koppla ett objekt. Du kan redigera det kopplade objektet genom att klicka p� det.

Ljudobjekt

L�nk till det kopplade ljudobjektet. Anv�nd drag och sl�pp fr�n huvudf�nstret eller urklippsf�nstret f�r att koppla ett objekt. Du kan redigera det kopplade objektet genom att klicka p� det.

Position

Anger x- och y-koordinaterna f�r ikonen. Exempel: f�r x = 100 och y = 55 anger du 100/55. Koordinaterna �r relativa det �vre v�nstra h�rnet av Workbench-f�nstret.

Visa namn

Om denna knapp �r kryssad visas objektets namn under ikonen.

7.7 Hur dockobjekt konfigureras

Dockobjekt inneh�ller information om dockf�nster. Redigeringsf�nstret inneh�ller f�ljande knappar:

Namn

Objektets namn. Det anv�nds ocks� som titel f�r f�nstret.

Direktval

Med detta direktval kan du �ppna och st�nga dockf�nstret.

Allm�n sk�rm

Anger den allm�na sk�rm som dockf�nstret skall �ppnas p�. Du m�ste ange ett giltligt namn p� en sk�rm om du vill att ToolManager automatiskt ska �ppna och st�nga dockf�nstret.

Teckensnitt

Det teckensnitt som ska anv�nds f�r knapptexterna.

Kolumner

Antal kolumner med knappar i dockf�nstret. Kolumner fylls med knappar fr�n v�nster till h�ger. Om den sista kolumnen i en rad fylls, l�ggs en ny rad till. Alla knappar kommer att ha samma storlek.

Position

Anger x- och y-koordinaterna f�r dockf�nstret. Exempel: f�r x = 150 och y = 200 anger du 150/200. Koordinaterna �r relativa det �vre v�nstra h�rnet av sk�rmen.

Knappar

Varje post i denna lista skapar en knapp. Den v�nstra kolumnen inneh�ller l�nken till det kopplade programobjektet; mittenkolumnen inneh�ller l�nken till det kopplade bildobjektet; och den h�gra kolumnen inneh�ller l�nken till det kopplade ljudobjektet. Anv�nd drag och sl�pp fr�n huvudf�nstret eller urklippsf�nstret f�r att koppla objekt. Du kan redigera det kopplade objektet genom att klicka p� det. Du kan anv�nda drag och sl�pp f�r att sortera posterna i listan. N�r du anv�nder knappen "Ta bort", tas det valda objektet bort fr�n listan. De kopplade objekten i sig tas inte bort.

Aktiverat

Dockf�nstret kommer att �ppnas n�r inst�llningarna har l�sts in.

Bakgrund

Dockf�nstret kommer att flyttas bak efter det att det har �ppnats.

Ram

N�r denna knapp �r kryssad kommer dockf�nstret att se ut som ett vanligt f�nster, med en ram och vanliga f�nsterknappar. Om knappen inte �r kryssad kommer det inte att ha n�gra ramar alls. Du kan bara flytta dockf�nstret om det har en ram.

Meny

En meny finns i dockf�nstret. Denna meny l�ter dig st�nga dockf�nstret, starta inst�llningsredigeraren f�r ToolManager, eller avsluta ToolManager.

Fr�mst

Om den h�r knappen �r kryssad kommer dockf�nstret alltid att �ppnas p� den fr�msta allm�na sk�rmen.

Popup

Dockf�nstret st�ngs automatiskt efter det att en knapp har valts.

Centrerat

Dockf�nstret �ppnas centrerat under muspekaren.

Klistrat

Normalt sett kommer dockf�nstret ih�g sin position n�r du st�nger det. Det kommer att �ppnas p� denna position om du �ppnar det igen. Om denna knappen �r kryssad kommer dockf�nstret alltid att �ppnas p� samma position.

Bilder

Knapparna i dockf�nstret kommer att visa bilder. Notera att du m�ste koppla bildobjekt till knapparna i s� fall.

Text

Knapparna i dockf�nstret kommer att visa namnet p� det kopplade programobjektet. Notera att du m�ste koppla programobjekt till knapparna i s� fall.

7.8 Hur man byter namn p� grupper

Du kan �ndra namnet p� gruppen med inmatningsf�ltet.

7.9 Urklipp f�r objekt

Det h�r f�nstret inneh�ller en lista med kopplade programobjekt, bildobjekt och ljudobjekt. Du kan dra och sl�ppa dem p� redigeringsf�nster. Du kan redigera de kopplade objekten genom att dubbelklicka p� dem. N�r du trycker p� knappen Ta bort tas det valda objektet bort fr�n listan. Objektet i sig tas inte bort.

Urklippet kan �ppnas fr�n menyn i huvudf�nstret. Du kan ha flera urklippsf�nster �ppna p� en g�ng.

7.10 Globala inst�llningar f�r ToolManager

Det h�r f�nstret l�ter dig �ndra de globala inst�llningarna f�r ToolManager. Det kan �ppnas fr�n menyn i huvudf�nstret. F�nstret inneh�ller f�ljande knappar:

Aktuell l�da

Anger den aktuella l�dan f�r ToolManager-processen. Alla filer utan en absolut s�kv�g kommer att �ppnas relativt denna l�da. Den f�rvalda l�dan �r roten p� uppstartsvolymen.

Inst�llningsredigerare

S�kv�g till sj�lva programmet f�r inst�llningsredigeraren f�r ToolManager. Den f�rvalda s�kv�gen �r ‘Sys:Prefs/ToolManager’.

N�tverk

St�ds f�r tillf�llet inte.

Omf�rgning

Aktivera omf�rgning av bilder (som l�ses av picture.datatype). St�ng bara av omf�rgningen om bilderna i dockf�nstret har fel f�rger.

Omf�rgningsprecision

Anger precisionen f�r omf�rgningen. Du kan f�rs�ka att �ndra detta v�rde om du inte �r n�jd med reslutatet av omf�rgningen.

Appendix A Hur ett direktval definieras

Det h�r kapitlet beskriver hur du definierar ett direktval som en inmatningsbeskrivning, som sedan tolkas av Commodities. Varje g�ng ett direktval aktiveras, genererar Commodities en h�ndelse. Denna h�ndelse anv�nds av TollManager f�r att aktivera ett programobjekt, eller f�r att v�xla ett dockobjekt. En inmatningsbeskrivning har f�ljande syntax:

[<typ>] {[-][<egenskap>]} [-][upstroke] [<tangentkod>]

Inget nyckelord �r l�gesk�nsligt.

Typ beskriver vilken typ av inmatningsh�ndelse (InputEvent) det �r. Denna parameter m�ste inte anges. Om den inte anges antas den vara rawkey (tangent). See section olika sorters inmatningsh�ndelser.

Egenskap �r "signaler" som m�ste vara satta eller rensade n�r direktvalet aktiveras f�r att en h�ndelse ska genereras. F�r varje egenskap som m�ste vara satt anger du motsvarande nyckelord. Alla andra egenskaper antas vara rensade. Om du vill ignorera en egenskap, ange ett - framf�r dess nyckelord. See section egenskaper.

En direktvalsh�ndelse genereras normalt sett n�r tangenterna trycks ned. Om du vill att h�ndelsen ska genereras n�r tantenterna sl�pps upp, ange d� nyckelordet upstroke. N�r b�de nedtryckning och uppsl�ppning ska generera en h�ndelse, ange -upstroke.

Tangentkoden beror p� vilken slags inmatningsh�ndelse det g�ller. See section tangentkoder.

Obs: Var f�rsiktig n�r du v�ljer dina direktval, eftersom Commodities har en h�g prioritet i inmatningskedjan. Detta betyder att existerande definitioner kommer att ignoreras.

A.1 Olika typer av inmatningsh�ndelser

Commodities st�djer de flesta typer av inmatningsh�ndelser som genereras av input.device. Denna sektion beskriver de typer som �r mest anv�ndbara f�r direktval i ToolManager.

rawkey

Detta �r den f�rvalda typen, och beskriver tangentbordsh�ndelser. Till exempel skapar rawkey a eller a en h�ndelse varje g�ng tangenten "a" trycks ned. Du m�ste ange en tangentkod f�r denna typ. See section rawkey.

rawmouse

Denna typ beskriver alla musknappsh�ndelser. Du m�ste ange en tangentkod f�r denna typ. See section rawmouse.

diskinserted

Denna h�ndelsetyp genereras n�r en diskett matas in i en diskettenhet. Denna typ har inte n�gra tangentkoder.

diskremoved

Denna h�ndelsetyp genereras n�r en diskett tas ut fr�n en diskettenhet. Denna typ har inte n�gra tangentkoder.

A.2 Egenskaper

Commodities st�djer f�ljande egenskaper:

lshift, left_shift

V�nster skifttangent.

rshift, right_shift

H�ger skifttangent.

shift

Godtycklig skifttangent.

capslock, caps_lock

Skiftl�stangenten.

caps

Godtycklig skifttangent eller skiftl�stangenten.

control, ctrl

Kontrolltangenten.

lalt, left_alt

V�nster alt-tangent.

ralt, right_alt

H�ger alt-tangent.

alt

Godtyckligt alt-tangent.

lcommand, lamiga, left_amiga, left_command

V�nster Amiga-/kommandotangent.

rcommand, ramiga, right_amiga, right_command

H�gre Amiga-/kommandotangent.

numericpad, numpad, num_pad, numeric_pad

Detta nyckelord m�ste anv�ndas f�r en tangent p� det numeriska tangentbordet.

leftbutton, lbutton, left_button

V�nster musknapp.

midbutton, mbutton, middlebutton, middle_button

Mittenmusknappen.

rbutton, rightbutton, right_button

H�ger musknapp.

repeat

Denna egenskap �r satt n�r tangentbordsrepeteringen �r aktiv. Den �r bara anv�ndbar f�r inmatningsh�ndelser av typen rawkey.

A.3 Tangentkoder

Varje typ av inmatningsh�ndelser har sina egna tangentkoder:

A.3.1 Tangentkoder f�r inmatningsh�ndelser av typen rawkey

a-z, 0-9, …

ASCII-tecken.

f1, f2, …, f10, f11, f12

Funktionstangenter.

up, cursor_up, down, cursor_down

left, cursor_left, right, cursor_right

Mark�rtangenter.

esc, escape, backspace, del, help

tab, comma, return, space, spacebar

Specialtangenter.

enter, insert, delete

page_up, page_down, home, end

Tangenter p� det numeriska tangentbordet. Var och en av dessa tangentkoder m�ste f�reg�s av egenskapen numericpad!

A.3.2 Tangentkoder f�r inmatningsh�ndelser av typen rawmouse

mouse_leftpress

V�nster musknapp har tryckts ned.

mouse_middlepress

Mittenmusknappen har tryckts ned.

mouse_rightpress

H�ger musknapp har tryckts ned.

Obs: F�r att anv�nda en av dessa tangentkoder, m�ste ocks� motsvarande egenskap ocks� anges, t.ex.

rawmouse leftbutton mouse_leftpress

A.4 Direktvalsexempel

ralt t

H�ll nere h�ger alt-tangent och tryck "t".

ralt lalt t

H�ll nere h�ger och v�nster alt-tangent och tryck "t".

alt t

H�ll nere en alt-tangent och tryck "t".

rcommand f2

H�ll nere h�ger Amiga-tangent och tryck den andra funktionstangenten.

numericpad enter

Tryck nyradstangenten p� det numeriska tangentbordet.

rawmouse midbutton leftbutton mouse_leftpress

H�ll nere mittenmusknappen och tryck v�nster musknapp.

diskinserted

Mata in en diskett i en diskettenhet.

Appendix B Vanliga fr�gor

H�r finns svaren p� de vanligaste fr�gorna om ToolManager:

• - N�r jag startar inst�llningsredigeraren f�r ToolManager f�r jag bara upp en dialogruta med texten "Program initialization failed". Vad �r det som �r fel?

  Inst�llningsredigeraren kontrollerar f�rst de grundl�ggande systemkraven innan det f�rsta f�nstret �ppnas. Se till att dessa systemkrav �r uppfyllda! Det kan ocks� vara s� att du inte har tillr�ckligt med minne f�r att k�ra inst�llningsredigeraren. Du kan beh�va avsluta n�gra andra program innan det finns tillr�ckligt med minne. Slutligen, du kan bara k�ra en kopia �t g�ngen av inst�llningsredigeraren.

• - Hur kan jag f� inst�llningsredigeraren f�r ToolManager att �ppnas p� en annan allm�n sk�rm �n Workbench-sk�rmen?

  V�lj alternativet MUI... i inst�llningsmenyn i huvudf�nstret. V�lj nu sidan f�r Systeminst�llningar och ange namnet p� den allm�na sk�rmen i inmatningsknappen. F�r n�rmare detaljer, se manualen till Information om MUI.

• - Efter att ha konverterat min gamla konfiguration fr�n ToolManager 2.x saknas en del bilder i dockf�nster, och vissa dockf�nster �ppnas inte alls!

  I dockf�nster st�djer ToolManager 3.0 bara bilder som kan l�sas av picture.datatype. I din gamla konfiguration har du kopplat n�gra bildobjekt till dockan, d�r bildobjekten refererar till ikoner. F�r att anv�nda s�dana ikoner m�ste du installera en datatyp f�r ikoner. Du kan hitta en s�dan datatyp p� t.ex. Aminet. Du kan ocks� konvertera dem till n�got annat format, som IFF-penslar.

• - Efter att ha konverterat min gamla konfiguration fr�n ToolManager 2.x saknas n�gra ikoner i Workbench-f�nstret!

  ToolManager 3.0 st�djer bara ikoner f�r ikonobjekt. I din gamla konfiguration har du kopplat bildobjekt som refererar till IFF-penslar till n�gra ikonobjekt. Du m�ste konvertera dem till ikoner f�r att anv�nda dem med ikonobjekt i ToolManager 3.0.

• - N�r jag anv�nder ikoner f�r bilder i dockf�nstret s� finns det lite extra text, eller s� har bilderna en tjock ram. Vad �r fel?

  Du har installerat en icon.datatype som inkluderar extra information fr�n ikonen i bilden. Kontrollera dokumentationen f�r ikondatatypen om hur du kan ta bort denna information. Om du inte gillar den tjocka ramen m�ste du �ven s�ga �t ikondatatypen att inte visa de vanliga ikonramarna.

• - Varf�r kan inte ToolManager skapa flera verktygsmenyer eller undermenyer?

  Flera menyer och undermenyer st�djs f�r tillf�llet inte av Workbench. F�r att skapa dem m�ste man anv�nda ett hack, vilket kan resultera i ett ostabilt system. D�rf�r kommer jag inte att implementera det i ToolManager.

• - Hur skapar jag en horisontell docka?

  S�tt bara antalet kolumner till antalet knappar i dockobjektet.

• - Hur f�r jag ett utmatningsf�nster f�r skalprogram?

  Utmatningsf�nster kan skapas genom att anv�nda enheten Con:. Anv�nd f�ljande filnamn f�r att skapa ett f�nster med en st�ngknapp, som �ppnas automatiskt, men inte st�ngs n�r programmet har slutat:

  CON:10/10/640/100/Utmatningsf�nster/AUTO/CLOSE/WAIT
  

  Con:-enheten har m�nga parametrar. Var god se din AmigaDOS-manual f�r mer information.

• - Hur kan jag f� argumenten i mitten av en kommandorad f�r ett skal- eller ARexx-program?

  Normalt sett l�ggs alla argumentet till i slutet av kommandoraden. F�r att infoga argumenten p� ett annat st�lle i kommandoraden, anv�nder ToolManager samma []-syntax som anv�nds av skalkommandot Alias. Till exempel:

  Dir [] all
  

  kommer att infoga alla argument innan nyckelordet all.

• - Hur skapar jag underdockor?

  Du m�ste anv�nda programobjekt med typen "Docka". Placera s�dana objekt i din huvuddocka, och de kommer att �ppna och st�nga de andra dockorna.

• - Dockf�nstrena f�rsvinner n�r Workbench-sk�rmen st�ngs och �ppnas igen.

  Du har gl�mt att s�tta namnet p� den allm�na sk�rmen f�r dockf�nstret till Workbench. ToolManager kommer att st�nga dockf�nstren n�r den allm�na sk�rmen st�nger, men ToolManager m�ste veta vilken allm�n sk�rm dockf�nstrena ska visas p� f�r att �ppna dem n�r sk�rmen �ppnas igen.

Appendix C History of ToolManager

3.0, Release date 23.02.1997

• - Again rewritten (almost) from scratch :-)
• - Old object system removed, TM objects are now BOOPSI objects
• - Now uses memory pools
• - Delay parameter removed from Exec Objects
• - Animation support removed from Image Objects
• - Picture.datatype V43 support added to Image Objects
• - Only icon images supported for Icon Objects
• - Only images loadable via picture.datatype are supported in Dock Objects
• - Pattern & Vertical flags and Title parameter removed from Dock Objects
• - Dock Objects can now display text and images
• - Dock Objects can now be completely borderless
• - New preferences file format, hopefully more flexible
• - Converter for the ToolManager 2.x format
• - Events are now checked while the configuration is read
• - Preferences is now a MUI application: resizable window, multiple open edit windows and Drag&Drop support
• - Changing an object name automatically updates all references to the object.
• - Support for grouping objects.
• - All dock objects get the screen notifications
• - Added support for DOSPath 1.0
• - CLI command lines are not limited to 4KB anymore
• - Installer script

2.1b, Release date 13.03.1996

• - Minor update to 2.1
• - Added support for WBStart 2.0

2.1a, Release date 26.03.1995

• - Minor update to 2.1
• - Added support for ScreenNotify 1.0
• - Included newer version of WBStart-Handler
• - Included missing AutoDocs for toolmanager.library

2.1, Release date 16.05.1993, Fish Disks #872 & #873

• - New Exec object types: Dock, Hot Key, Network
• - New Dock object flags: Backdrop, Sticky
• - New object type: Access
• - Network support
• - Editor main window is now an AppWindow
• - Gadget keyboard shortcuts in the preferences editor
• - New tooltypes for the preferences editor
• - Several bug fixes
• - Enhanced documentation

2.0, Release date 26.09.1992, Fish Disk #752

• - Complete new concept (object oriented)
• - (Almost) Complete rewrite
• - ToolManager is now split up into two parts
• - Main handler is now embedded into a shared library
• - Configuration is now handled by a Preferences program
• - Configuration file format has changed again :-) It is an IFF File now and resides in ENV:
• - Multiple Docks and multi-column Docks
• - Docks with new window design
• - Dock automatically detects largest image size
• - Sound support
• - Direct ARexx support for Exec objects
• - ToolManager can be used without the Workbench. If the Workbench isn’t running, it won’t use any App* features.
• - Locale support
• - Path from Workbench will be used for CLI tools
• - Seperate Handler Task for starting WB processes

1.5, Release date 10.10.1991, Fish Disk #551

• - Status Window: New/Open/Append/Save As menu items for config file
• - Edit Window: File requesters for file string gadgets
• - Added a Dock Window (a la NeXT)
• - Added a DeleteTool
• - A list of all active HotKeys can be shown
• - Tools can be moved around in the list
• - Icon positioning in the edit window added
• - Name of the program icon can be set
• - CLI tools can have an output file and a path list
• - Uses UserShell for CLI tools
• - Maximum command line length for CLI tools is now 4096 Bytes
• - AppIcons without a name are supported now
• - Workbench screen will be moved to front if you pop up the Status window
• - Workbench screen can be moved to front before starting a tool via HotKey
• - TM will wait up to 20 seconds for the workbench.library
• - Added a DELAY switch which causes TM to wait <num> seconds before adding any App* stuff
• - renamed some tooltypes/parameters
• - some visual cues added
• - some internal changes

1.4, Release date 09.07.1991, Fish Disk #527

• - Keyboard short cuts for tools
• - AppIcons for tools
• - Menu item can be switched off
• - Configuration file format completely changed (hopefully the last time)
• - CLI commandline parsing is now done by ReadArgs()
• - Status & edit window updated to new features
• - Safety check before program shutdown added
• - Menu item “Open TM Window” only appears if the program icon is disabled
• - WB startup method changed. Now supports project icons
• - several internal changes

1.3, Release date 13.03.1991, Fish Disk #476

• - Now supports different configuration files
• - Format of the configuration file slightly changed
• - Tool definitions can be changed at runtime
• - Now supports CLI & Workbench startup method
• - Selected icons are passed as parameters to the tools
• - Now uses the startup icon as program icon if started from Workbench
• - The position of the icon can now be supplied in the configuration file
• - The program icon can now be disabled
• - New menu entry “Show TM Window”
• - Every new started ToolManager passes its startup parameters to the already running ToolManager process

1.2, Release date 12.01.1991, Fish Disk #442

• - Status window changed to a no-GZZ & simple refresh type (this should save some bytes)
• - Status window remembers its last position
• - New status window gadget “Save Configuration”: saves the actual tool list in the configuration file
• - Small bugs removed in the ListView gadget handling
• - Name of the icon hard-wired to “ToolManager”

1.1, Release date 01.01.1991

• - Icons can be dropped on the status window
• - Status window contains a list of all tool names
• - Tools can be removed from the list

1.0, Release date 04.11.1990

• - Initial release

Appendix D F�rfattaren skulle vilja tacka…

ToolManager har g�tt igenom m�nga utvecklingsfaser sedan den f�rsta implementationen 1990. Denna utveckling skulle inte ha varit m�jlig utan den enorma responsen fr�n olika ToolManager-anv�ndare. M�nga id�er och funktioner kommer fr�n denna k�lla…

D�rf�r skulle jag vilja tacka:

F�r alfa-/beta-testning, id�er och felrapporter:

Osma Ahvenlampi, Stephane Barbaray, Olaf Barthel, Fionn Behrens, Mario Cattaneo, Michael van Elst, Michael Hohmann, Markus Illenseer, Frank Mariak, Klaus Melchior, Bernhard Moellemann, Matthias Scheler, Ralph Schmidt, Tobias Walter.

Matthew Dillon

Utan ditt utm�rkta C-utvecklingssystem DICE, och diverse andra verktyg, skulle ToolManager inte existera!

Alla anv�ndare som har skickat mig pengar:

Ert st�d har gjort den h�r versionen m�jlig.

Alla an�ndare som har skickat mig en kommentar:

Jag tyckte verkligen om att l�sa era brev och e-brev!

ToolManager anv�nder f�ljande paket:

picture.datatype V43

Upphovsr�tt © 1995–1996 Ralph Schmidt, Frank Mariak &
Matthias Scheler

WBStart 2.2

Upphovsr�tt © 1991–1996 Stefan Becker

ScreenNotify 1.0

Upphovsr�tt © 1995 Stefan Becker

DOSPath 1.0

Upphovsr�tt © 1996 Stefan Becker

MUI

Upphovsr�tt © 1993–1997 Stefan Stuntz
Hemsida: http://www.sasg.com/.

Pophotkey.mcc, Popport.mcc, Popposition.mcc

Upphovsr�tt © 1996–1997 Klaus Melchior

Ikoner

Upphovsr�tt © 1995 Michael W. Hohmann

Appendix E Information om MUI

                      Det h�r programmet anv�nder


                       MUI - MagicUserInterface

               (c) Upphovsr�tt 1993-97 av Stefan Stuntz


MUI �r ett system f�r att skapa och hantera grafiska anv�ndargr�nssnitt.
Med hj�lp av en inst�llningsredigerare kan anv�ndaren av ett program
anpassa utseendet p� programmet i enighet med sin personliga smak.

MUI �r shareware. F�r att skaffa det kompletta paketet, inneh�llande m�nga
exempel och mer information om registrering, leta efter en fil som heter
"muiXXusr.lha" (XX betyder det senaste versionsnumret) p� din lokala BBS
eller p� disketter med fria program.

           Om du vill registrera MUI redan nu, skicka g�rna


                          30 DM eller 20 US$

                                 till

                             Stefan Stuntz
                       Eduard-Spranger-Stra�e 7
                             80935 M�nchen
                                GERMANY



               Support och registrering online finns vid

                        http://www.sasg.com/

Index

Table of Contents

About This Document

This document was generated on August 24, 2022 using texi2html 5.0.

The buttons in the navigation panels have the following meaning:

where the Example assumes that the current position is at Subsubsection One-Two-Three of a document of the following structure:

• 1. Section One
  • 1.1 Subsection One-One
    • ...
  • 1.2 Subsection One-Two
    • 1.2.1 Subsubsection One-Two-One
    • 1.2.2 Subsubsection One-Two-Two
    • 1.2.3 Subsubsection One-Two-Three     <== Current Position
    • 1.2.4 Subsubsection One-Two-Four
  • 1.3 Subsection One-Three
    • ...
  • 1.4 Subsection One-Four

This document was generated on August 24, 2022 using texi2html 5.0.